home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / mouse tools / pointerx / pointerx.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  12KB  |  259 lines
  1. @DATABASE "Elysian Fields"
  2. ## This should be read with an Amigaguide (tm) reader such as MultiView
  3. ## if you don't own such software, then read the .doc file instead ;-)
  4. @NODE "Main" "Contents"
  5.                    .oO
  6.                    
  7.                 PointerX 3.05
  8.                    _______
  9.                    
  10. Oo.oO
  11.  1994 Dave Jones aka Te
  12. Contents:
  13. ~~~~~~~~~
  14.  @{" 1.  Archive contents.       " LINK "ArchiveContents"}    @{" 7.  Technical Information.    " LINK "TechInfo"}
  15.  @{" 2.  Distribution.           " LINK "Distribution"}    @{" 8.  History.           " LINK "History"}
  16.  @{" 3.  What does it do and why ? " LINK "WhatDoesItDo"}    @{" 9.  Future?           " LINK "Future"}
  17.  @{" 4.  Requirements.           " LINK "Requirements"}    @{" 10. About the author.       " LINK "AboutMe"}
  18.  @{" 5.  Usage.            " LINK "Usage"}    @{" 11. Contact Address.       " LINK "Contact"}
  19.  @{" 6.  Bugs.               " LINK "Bugs"}    @{" 12. Thanks.           " LINK "Thanx"}
  20. @ENDNODE
  21. @NODE "ArchiveContents" "Archive Contents"
  22. 1. Archive contents.
  23. ~~~~~~~~~~~~~~~~~~~~
  24. The archive you recieved `PointerX_304.Lha' should contain the following
  25. files (Plus possibly some BBS adverts)
  26.     PointerX    ................... This is the executable
  27.     PointerX.doc    ................... Normal ascii ver of this file.
  28.     PointerX.Guide    ................... This file!
  29. And no other files.
  30. PointerX needs no libraries/devices e.t.c., it is a stand-alone program.
  31. @ENDNODE
  32. @NODE "Distribution" "Distribution"
  33. 2. Distribution.
  34. ~~~~~~~~~~~~~~~~
  35. PointerX is a giftware program, i.e. if you like/use it, then send me a
  36. gift of some sort.. any kind of miscellaneous rubbish ;-)
  37. Just brighten my day, by letting me know that someone uses PointerX
  38. In return, (Depending on how busy my life is at the time) I may even
  39. write to you occasionally, sending you updates/other programs e.t.c...
  40. Permission is granted for you to spread this archive across all electronic
  41. storage mediums BBS,InterNet e.t.c... as long as the files are not modified
  42. in any way whatsoever.
  43. Permission is also granted for this program to be included in any PD CD
  44. collections (As long as you send me a copy guys.. what you say huh? ;-)
  45. It also cool for magazines to put this on their coverdisks.
  46. @ENDNODE
  47. @NODE "WhatDoesItDo" "What Does it do ? And why ?"
  48. 3. What does it do and why ?
  49. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  50. A few months ago, I bought a copy of `Amiga User International', which
  51. had a program called PointerX 2.0 on the coverdisk.
  52. Cool!, This program makes the hands on the busy pointer spin!
  53. But, after loading the program on my 1200, it refused to animate the busy
  54. pointer!
  55. So, I threw the disk back into the diskbox, and continued with everyday life.
  56. That was, until an hour ago, when I was soooo bored whilst waiting for a
  57. program to assemble, that I thought, `shame PointerX don't work, it'd look
  58. real neat right now...'
  59. I then decided to disassemble the PointerX program, and make it work on all
  60. machines.
  61. A while later, and PointerX 3 was born.
  62. @ENDNODE
  63. @NODE "Requirements" "Requirements"
  64. 4. Requirements.
  65. ~~~~~~~~~~~~~~~~
  66. To run PointerX you need...
  67.  Workbench 2 or above. (Yup, now even WB3 is okay!)
  68.  Something that sets the busy `clock' icon
  69.     (To test it, Load a workbench, select `execute program' and click
  70.      back in the workbench screen ;^)
  71. No other requirements whatsoever.
  72. @ENDNODE
  73. @NODE "Usage" "Usage"
  74. 5.Usage.
  75. ~~~~~~~~
  76. To run PointerX, simply type PointerX in the CLI, or doubleclick it from
  77. workbench. (Anyone wanna draw me an icon?)
  78. To abort, you can send the program a Ctrl-C signal (With Xoper,ARTM e.t.c..)
  79. and the program will restore everything and exit gracefully.
  80. PointerX can now also be removed by simply running it again.
  81. @ENDNODE
  82. @NODE "Bugs" "Known bugs"
  83. 6.Bugs!
  84. ~~~~~~~
  85.  Not really, a bug, but something I have to workaround sometime..
  86.   1) Boot a disk without running PointerX
  87.   2) Do something which will set a busy pointer (A file requestor is a
  88.      good method - Click outside the filerequestor window.)
  89.   3) Whilst it's still the busy pointer, load PointerX.
  90.   4) Note how it doesn't spin. If you cancel the requestor, and then
  91.      select it again, they will spin. ;-)
  92.   5) Also, if you remove PointerX while a busy pointer is spinning, the
  93.      hands will stay at that position until you cancel the requestor ;-)
  94.   This isn't really a problem, and doesn't rank too highly on my `to do' list
  95. @ENDNODE
  96. @NODE "TechInfo" "Technical Information"
  97. 7. Technical Information.
  98. ~~~~~~~~~~~~~~~~~~~~~~~~~
  99.  Coded in 100% Assembly Language for speed and size. (or lack of size!)
  100.   The Source code length is 897 lines including Pointer sprites as Dc.w's
  101.  Code is 100% PC relative, which means it will load at any address without
  102.   any need for relocation. Let's see `C' coders write a program like that!
  103.  Utilises fast memory if available. [ regardless of location ]
  104.  The code will free any allocated memory / libraries and exit gracefully
  105.   on failure / exit.
  106.  Autodetatches from CLI (No need to `RUN PointerX')
  107.  Each version of PointerX has been tested extensively with Enforcer, and
  108.   returns no hits. [ Unless my serial lead is broken again ;^( See V3.04! ]
  109.  Each version of PointerX has had extensive testing by myself and my
  110.   ever faithful army of 
  111. eta-testers who will (hopefully) be sure to let me
  112.   know if there are any problems ;-)
  113.  Some people have suggested that I shouldn't take credit for PointerX 3,
  114.   but I would like to point out, that very little of Steve Tibbetts
  115.   PointerX 2 remains in my version.
  116.   The only unchanged remnants, are the pointer graphic data.
  117.   EVERYTHING has been recoded, not from scratch, but still, it looks a darn
  118.   sight different from Steve's version.
  119.   Incidentally Steve, if you're interested in the source code for this, then
  120.   drop me a line (With some kind of proof that you are THE Steve Tibbett
  121.   - The original source for PointerX 2 would probably be proof enough..)
  122.  PointerX has been developed on an A1200HD with 68030 MMU/FPU and 2mb
  123.   of lovely 32 bit fastram. (Yummy.)
  124. @ENDNODE
  125. @NODE "History" "History of this program"
  126. 8.History.
  127. ~~~~~~~~~~
  128.  1.0        No information.
  129.  2.0        First version I owned.
  130.  Only works on kickstart 2.04
  131.  Written by Steve Tibbett.
  132.  3.0   28.9.94    Released only to 
  133. eta testers
  134.  I (Dave Jones) took over.
  135.  Some obvious optimizations were made.
  136.  Now works on WB3, as I now patch the
  137.           Intuition/SetWindowPointerA() function as well as the
  138.           Intuition/SetPointer() function.
  139.  Added auto-detatch code, no more need to `RUN PointerX'.
  140.  3.01  23.10.94    First Full Public Release - Appeared on the coverdisk
  141.         of Amiga User International.
  142.  Fixed NewSetWindowPointer().
  143.            It no longer causes Enforcer hits.
  144.  If you now run PointerX twice, it'll Uninstall itself.
  145.  Uses FastMem if available.
  146.  Improved auto-detatch code.
  147.  Various small optimizations.
  148.  3.02 27.10.94    Not publically released. Released only to Beta testers
  149.  More PC relativity added.
  150.  Some obscure optimizations added.
  151.  3.03 7.11.94    Not released : personal test version
  152.  Code is now 100% PC Relative.
  153.  Code has had loads of optimizations made, both for speed
  154.            and size, and is now as small and fast as possible. (IMHO)
  155.  Fixed a harmless bug in the auto-detatch code.
  156.  Removed some redundant code.
  157.  Finally removed some spelling mistakes in this doc!
  158.           previous versions stated I was 21, Hmm.. too much Vodka..
  159.           (or maybe not enough ;-)
  160.  3.04 8.11.94     Second public release.
  161.  Removed an enforcer hit that's been there since ?????
  162.           My serial lead was broken, so my terminal wasn't getting
  163.           the enforcer hit messages! Sorry!
  164.  Some more small optimizations, removal of duplicate code.
  165.  Now uses minimal amount of CPU time even when in the
  166.           `busy' state. - Virtually nil when not `busy'.
  167.  Corrected several mistakes in the docs, which referenced
  168.           MoveVBR (One of my other programs) that's what you get
  169.           for being lazy, and modifying another doc. ;-)
  170.  3.05 26.12.94     Third public release - Uploaded to InterNET in a last-ditch
  171.         attempt to get some fame! Send me mail! Just to let me know
  172.         that people are using PointerX 3 !
  173.  Uses an optimized SegSplit routine, which saves 4 bytes
  174.           Yippee. (!)
  175.  Now includes a rather nice icon.
  176.  More spell checking done on docs ;-
  177. @ENDNODE
  178. @NODE "Future" "What beholds the future ?"
  179. 9. Future.
  180. ~~~~~~~~~~
  181.  Fixing of any bug reports. (None I hope ;-)
  182.  Maybe have a parameter to adjust the speed at which the hands spin ?
  183.  Any suggestions ?
  184. @ENDNODE
  185. @NODE "AboutMe" "Misc waffle about the author"
  186. 10. About the Author.
  187. ~~~~~~~~~~~~~~~~~~~~~
  188. I'm a 20 year old male (born 6th Feb 1974 - Birthday presents welcome ;-)
  189. I work 9-5 as a data entry clerk with a finance firm, which is sooooooo
  190. boring ;-(  I've been a commercial programmer for a while, which may seem
  191. like the ideal job, but when your getting a regular wage for your coding,
  192. it seems to take away all the fun.
  193. Now, I code just for fun which is much more rewarding, but pays less. ;-)
  194. (Anyone wanna send me some bribes ?)
  195. @ENDNODE
  196. @NODE "Contact" "Contact Address"
  197. 11. Contact Address.
  198. ~~~~~~~~~~~~~~~~~~~~
  199. Feel free to contact me for donations, presnts, flames, bug-reports, ideas,
  200. requests, or even just to say hello..
  201. also feel free to contact me if you have a program you'd like to see
  202. fixed/improved for WB2/3
  203.  Dave Jones.
  204.  40,Heol Edward Lewis,
  205.  Gelligaer,
  206.  Hengoed,
  207.  Mid Glamorgan,
  208.  Cf8 8ej,
  209.  South Wales,
  210.  U.k.
  211. Including postage guarantees 1 day turnaround.
  212. You can also send me E-Mail at Narc/Destiny's address.
  213.             spe3kdr@cardiff.ac.uk
  214. *NB - Coz this isn't MY net address, chances are you could be waiting a week
  215. or so for a reply, you'll get a faster reply (probably) by snail-mail ;-)
  216. - Kinda ironic huh ?
  217. @ENDNODE
  218. @NODE "Thanx" "Thanks / Greets e.t.c."
  219. 12. Thanx/ Greetz e.t.c...
  220. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  221.     Massive Appreciation to the following exalted members
  222.             of the human race:
  223.  Commodore for the machine.
  224.  Motorola for 680x0  Intel Outside!
  225.  HiSoft for Devpac 3.04
  226.  Golden Wonder for Pot Noodles.
  227.  Pink Floyd, MegaDeth for musical support during development.
  228.  Whoever invented headfones (For late night development ;-)
  229.  Narc / Destiny for the loan of his 1200HD for a short while ;-)
  230.   I really should buy my own.. Donations please readers... ahem..
  231.  Morten Erikson for PicCon 2.32
  232.  - Where the hell are you?
  233.  Klaus Deppisch for Diskspare.device v3 which is great.
  234.  Chris Green & Dave Haynie, Ex-CBM for writing cool software.
  235.  Michael Sinz for Enforcer.
  236.     Specially huge amounts of hatred and Buckets of cess
  237.     ridden filth to the poor downtroden victims that follow:
  238.  The security guards at Cardiff University for not letting me in for
  239.   free InterNET access any more ;-( B**t*rds!
  240.  Mehdi Ali for Screwing Commodore into the state it's in now.
  241.  Motorola for not sending me the MMU books I asked for... Hmph.. ;-(
  242.   (Anyone got any MMU docs ?)
  243.  HiSoft for Devpac 3.15 which is totally screwed on my setup.
  244.   Fancy blaming the Ram-Speed of my lovely Viper30.. Shame on you.
  245.  Michiel Pelt - For not including any disk salvage utilities with PFS
  246.   PLEASE! Someone write a disksalv for this otherwise amazing program.
  247.   (Must 
  248.  write everything ? ;^)
  249.   BTW: PFS9 has some real bad bugs in it... Truncating files etc...
  250.  Future Publishing for the lamest computer show ever.
  251.   FES 94 Was so small, how could you justify such an extortionatly large
  252.   entrance fee? If any of your staff use LibMon, please donate a 
  253. To everyone who uses my other utilities, but is too tight to even send
  254.   me a postcard... Darn you...
  255.   That means YOU! user of PointerX, MoveVBR, SquashText, LibMon,
  256.   HunkMaster e.t.c.
  257.   Maybe I'll start crippling my shareware.. Hmm. Is this what it takes ?
  258. @ENDNODE
  259.